home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / saveload.zip / SAVELOAD.DOC < prev   
Text File  |  1990-09-17  |  33KB  |  747 lines
  1.                    SAVE and LOAD File Utilities
  2.  
  3.                            October, 1989
  4.  
  5.                       Program Documentation
  6.  
  7.                    Copyright (C) 1989 Battelle
  8.                       All Rights Reserved
  9.  
  10.  
  11.  
  12. Introduction
  13. ------------
  14.  
  15. The SAVE/LOAD programs were developed at Battelle because of a need
  16. for a convenient file transfer mechanism between different MS-DOS
  17. based computer systems. Surprising as it may seem, there doesn't
  18. appear to be a convenient and reliable means of transferring files
  19. between different computer systems, except in special circumstances
  20. when all computer systems are configured the same or nearly the same. 
  21. There are several problems associated with transferring files between
  22. different systems:
  23.  
  24.      o    Normal backup/restore software is not always convenient to
  25.           use because many of these packages set the 'archive' flag,
  26.           which then confuses your normal backup/restore procedures
  27.           (the next time you do a backup, your backup software thinks
  28.           that it has already backed up a modified file that was
  29.           involved in the transfer). Some backup packages provide a
  30.           means of not setting the 'archive' flag, but you have to
  31.           remember to go into your backup software, set this option,
  32.           perform the backup, and then reset the option. This often
  33.           can be time-consuming and confusing.
  34.  
  35.      o    Disregarding the problems associated with the above for the
  36.           moment, the DOS BACKUP/RESTORE might be a convenient
  37.           mechanism for file transfer except that the format of
  38.           backup files changed between versions 3.2 and 3.3 resulting
  39.           in version 3.2 not being able to read 3.3 backups. In
  40.           addition, version 3.3 BACKUP/RESTORE will not run under
  41.           version 3.2, etc.
  42.  
  43.      o    DOS's COPY or XCOPY are useful if you don't have files
  44.           larger than the capacity of the transfer media you are
  45.           using. However, sometimes you do have large files which
  46.           can't be accommodated by this
  47.           method.
  48.  
  49.      o    Third party backup/restore software might be a good
  50.           solution (disregarding the archive flag issue), except that
  51.           you must install these usually large programs on the
  52.           computer system you are transferring the files to if they're
  53.           not already there. This installation can involve a certain
  54.           amount of time because you sometimes have to "tune" it to
  55.           the machine.
  56.  
  57. For these reasons and others, the SAVE and LOAD programs were
  58. developed. The basic criteria for these programs were:
  59.  
  60.      o    They should be convenient to use with little setup time.
  61.      o    They had to be capable of transferring large files.
  62.      o    They shouldn't disturb the normal backup process.
  63.      o    They should be as small as possible to avoid carrying
  64.           around excess software.
  65.      o    They should function on all DOS operating systems from 2.0
  66.           thru 4.x.
  67.      o    They should be as reliable as possible.
  68.      o    They should be fairly efficient although this wasn't of
  69.           utmost importance (reliability was the more important
  70.           factor).
  71.  
  72. The basic functioning of SAVE and LOAD is similar to DOS BACKUP and 
  73. RESTORE. This model was selected since many users are already 
  74. familiar with these utilities:  SAVE is like BACKUP, LOAD is like 
  75. RESTORE. Much of the functions of BACKUP/RESTORE can be performed 
  76. under SAVE/LOAD. However, since the primary purpose of SAVE/LOAD was 
  77. not backup, the default options are somewhat different to 
  78. accommodate the criteria listed above. It was decided not to 
  79. incorporate a menu oriented system into SAVE/LOAD because typically 
  80. such systems increase the executable size considerably. In addition,
  81. these systems sometimes make automatic batch execution difficult 
  82. (although they are certainly more user-friendly). The separation of 
  83. functions into two programs, SAVE and LOAD, was also convenient in 
  84. that only LOAD need be taken to install files on the destination 
  85. computer. There is a provision available to execute LOAD directly 
  86. from the transfer disk so no install is required.
  87.  
  88. Both SAVE and LOAD are documented in the following pages. Examples
  89. of various options are also presented. Please refer to these 
  90. examples for specific requirements.
  91.  
  92. SAVE and LOAD have been tested extensively, although not all 
  93. possible configurations were available for test. Consequently, there 
  94. might be some cases in which the software doesn't function properly. 
  95. If you find this is the situation, we would appreciate your letting 
  96. us know so that we can fix the problem. Even if you don't find any 
  97. problems, we would still like to hear from you regarding future 
  98. enhancements that might make these utilities more useful.
  99.  
  100. Suggestions/problems can be posted to CompuServ ID [76117,2611] or
  101. you can write directly to:
  102.  
  103.     Battelle
  104.     P.O. Box 8399
  105.     Columbus, Ohio  43201
  106.  
  107.  
  108. SAVE
  109. ----
  110.  
  111. The SAVE program may be used to save/backup one or more DOS files
  112. from one disk to another. Typically, the disk to which the files are
  113. transferred is a floppy disk, although hard disks may also be used. 
  114. When used in conjunction with the LOAD program, you have a quick and
  115. convenient means of copying files from one computer system to another
  116. without affecting current backup procedures.
  117.  
  118. The general syntax for executing SAVE is as follows:
  119.  
  120.    SAVE <source-path> <destination-drive> <switches>
  121.  
  122. where:
  123.  
  124.      <source-path>       is any valid DOS file path specification
  125.                          which specifies the files to be saved. This
  126.                          specification may include the wildcard
  127.                          characters '*' and '?'. The <source-path>
  128.                          must include the source drive specification. 
  129.                          For example, a <source-path> specification
  130.                          might be C:\XXX\*.COM which indicates that
  131.                          all COM files on the C drive in the XXX sub-
  132.                          directory are to be saved.
  133.  
  134.      <destination-drive> is any valid DOS drive specification which
  135.                          specifies where the files will be placed. 
  136.                          For example, a <destination-drive>
  137.                          specification might be A: which indicates
  138.                          that the A floppy disk is where SAVE should
  139.                          place the saved files.
  140.  
  141. There are a number of <switches> which may be used to modify the 
  142. general behavior of SAVE. A short summary is given below with a more
  143. complete explanation on the following pages:
  144.  
  145.      /s             Include all subdirectories.
  146.      /a             Append to current save information.
  147.      /m             Save only modified files.
  148.      /n             Do not delete current files on destination disk.
  149.      /b             Set backup up (archived) status in source files.
  150.      /c             Compress source files while saving to destination
  151.                     disk.
  152.      /e             Estimate amount to be saved.
  153.      /x             Don't prompt for first save disk.
  154.      /d:<mm-dd-yy>  Save files modified on or after the date
  155.                     <mm-dd-yy>.
  156.      /t:<hh:mm:ss>  Save files modified on or after the time
  157.                     <hh:mm:ss>.
  158.      /l:<filename>  Create/update save log on <filename>.
  159.  
  160.      This summary can be obtained by invoking SAVE without parameters.
  161.  
  162.  
  163. SAVE Switches
  164. -------------
  165.  
  166.   Switch                     Function
  167. ----------     -------------------------------------------------
  168.  
  169.  /s            In addition to the files indicated by the source path
  170.                specification, all subdirectories beneath the source
  171.                path will also be searched using the file
  172.                specification given in <source-path>.
  173.  
  174.  /a            This switch indicates that files which match the
  175.                source path specification should be appended to
  176.                currently existing SAVE informatio